home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / workbench / libs / gutil_usr_379.lha / GadUtil / Docs / GadUtil_usr.readme < prev    next >
Text File  |  1996-12-22  |  10KB  |  245 lines
  1. Short:    GUI creation library (small & fast)
  2. Author:   P-O Yliniemi / Staffan Hämälä
  3. Uploader: peoyli@algonet.se (P-O Yliniemi)
  4. Version:  37.9
  5. Type:     util/libs
  6.  
  7. This is the user distribution of GadUtil library. If you are interested
  8. in developing programs that uses this library, you should get the
  9. distribution from dev/gui on Aminet.
  10.  
  11. For advanced "normal" users:
  12. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  13. Two versions of the library are included: one "normal" every-day-use
  14. version and one "debug" version. If you experience any trouble running
  15. a program that uses gadutil, you should rename the normal version in libs:,
  16. copy the debug version to libs, and rename it to gadutil.library. Reverse
  17. this to change back to the normal version. Don't forget to "flush" all
  18. unused libraries or reboot before testing the program again.
  19.  
  20. Changes overview:
  21. ~~~~~~~~~~~~~~~~~
  22. * 37.9  (22-Dec-96)
  23.         6 new tags added for the help functions. It is now possible to set a default
  24.         help text that will be shown if no gadget is under the pointer.
  25.  
  26.         GU_DefWTitle            - default window title
  27.         GU_DefLocWTitle         - localized window title
  28.         GU_DefSTitle            - default screen title
  29.         GU_DefLocSTitle         - localized screen title
  30.         GU_DefHelpText          - default help text
  31.         GU_DefLocHelpText       - localized help text
  32.  
  33.         A little bug removed from the help routines. Versions beore 37.9 could
  34.         display two different help text at the same time (in different gadgets or
  35.         the screen or window title).
  36.  
  37.         A new include file is included in the distribution now. Now it should be
  38.         possible to compile the examples with older versions of the system include
  39.         files (OS 2.0x includes are supported now)
  40.  
  41.         A third archive with the HTML version of the GadUtil documentation is
  42.         included in the distribution now. Also included with this archive is some
  43.         pictures of applications using GadUtil.
  44.  
  45.         The distribution has changed a bit, resulting in that the archive with all
  46.         files became smaller (developer archive only).
  47.  
  48. * 37.8  (15-Jul-96)
  49.         Some bug fixes in the new help functions. If 0 was used as data on a GU_HelpText
  50.         tag with a gadget that shows the help text in the window's or screen's title,
  51.         there were some enforcer hits
  52.  
  53.         Deleted the separate autodoc files. Appended some information on the contents of
  54.         the GU_Public structure to the autodocs. More info about SCRTITLE_HELP and
  55.         WINTITLE_HELP was also appended.
  56.  
  57.         Changed the help function so that all gadgets and title bars that are used to
  58.         display help strings is cleared if the mouse pointer is outside all gadgets that
  59.         have help texts.
  60.  
  61. * 37.7  (12-Jul-96)
  62.     Bug fix in the prototype for GU_ChangeStr (two parameters was mixed up).
  63.  
  64.     GU_ChangeStr now works for both STRING_KIND and TEXT_KIND gadgets. If the
  65.     gadget isn't a STRING or TEXT gadget nothing is done.
  66.  
  67.     Bug fix in GU_CoordsInGadBox function. The register D3 was trashed in all
  68.     earlier versions of GU.
  69.  
  70.     Three new tags allows any STRING or TEXT_KIND gadget to show a (localized)
  71.     help text for each gadget in the window. These tags also works with the
  72.     special gadgets (BEVELBOX, LABEL, PROGRESS). The gadgets attached to the
  73.     window is scanned in sequential order. If a BEVELBOX_KIND gadget matches
  74.     the pointer position, this gadget's help string will have the lowest
  75.     priority. If another BEVELBOX is found inside this, the help string for
  76.     that one will be used if there is no gadget inside that box. The help
  77.     text can also be displayed in the window/screen title.
  78.  
  79.     The TEXT_KIND, STRING_KIND, NUMBER_KIND and INTEGER_KIND gadget's current
  80.     value can now be read from the gu_Active field in the structure    that
  81.     gg_UserData points to.
  82.  
  83. * 37.6  (15-Jun-96)
  84.     gu_Active in the structure that gg_UserData points to was not updated
  85.     when using any routine that used GU_SetGadgetAttrsA(). Now it checks
  86.     the gu_Active value to see if it is out of the gadget's limits.
  87.  
  88.     gng_Flags and gng_GadgetText is now cleared before creation of every
  89.     new gadget.
  90.  
  91.     The LAYOUTA_Spacing tag for LISTVIEW_KIND gadgets is now used to
  92.     determine the height of the gadget. If the height of a gadget should
  93.     be about 4 lines (GU_HeightFactor, 4), the height of the gadget is
  94.     calculated to 4*(font height+value of LAYOUTA_Spacing tag). The same
  95.     method is used for the GU_AddHeiLines tag.
  96.  
  97.     Hotkeys for LISTVIEW_KIND gadgets works as they should again. In v37.5
  98.     of GadUtil (and probably some earlier ones), the listview didn't scroll
  99.     down when you selected the next entry.
  100.  
  101.     Inserted pragmas and prototypes for tagcalls (pragmas only for SAS/C).
  102.     It is possible to create stub routines for the tagcalls for other
  103.     compilers by using fd2pragma 2.0.
  104.  
  105.     Inserted links to the include files in the index file for GadUtil.guide.
  106.  
  107. * 37.5  (29-May-96)
  108.     Bug in PROGRESS_KIND gadget removed. If the gadget was set to
  109.     show x/0 (also 0/0), a division by zero was done.
  110.  
  111.     Two new constants added to the include files: GADUTIL_VER and
  112.     GADUTIL_REV.
  113.     
  114.     Bug fixes in test (demo) programs. The FPF_DISKFONT flag in the
  115.     TextAttr structure was unset in all demo programs. Replaced the
  116.     manual version check in the demo programs with the GadUtil function
  117.     GU_CheckVersion. Removed unnecessary IDCMP flags from the demo
  118.     programs and replaced GadTools IDCMP with the GU_MinimumIDCMP tag.
  119.  
  120. * 37.4  (14-May-96)
  121.     Created a new gadget kind: LABEL_KIND. This gadget kind is used
  122.     to place text relative to other gadgets, bevel boxes, and other
  123.     texts. Can use the same type of shadows that the text for the
  124.     bevel box.
  125.  
  126.     Implemented a new function in the library: GU_CloseFont. Works
  127.     like graphics CloseFont, but takes the parameter in A0 instead
  128.     of A1.
  129.  
  130.     Replaced the list sort routine with a new one that sorts better.
  131.  
  132.     Wrote a new document, "GadUtil.index", that have a list over all
  133.     gadutil functions, sorted by what they do. There are also some
  134.     shortcuts to all tags for gadutil's own gadget kinds.
  135.  
  136.     Created two new flags for BEVELBOX_KIND and LABEL_KIND:
  137.     BB_3DTEXT - can be used as a replacement for GUBB_3DText, TRUE
  138.     LB_3DTEXT - can be used as a replacement for GULB_3DText, TRUE
  139.  
  140. * 37.3  (10-May-96)
  141.     Enforcer hits fixed in the code that handles the GU_AdjustLeft
  142.     and GU_AdjustRight tags.
  143.  
  144.     A new function to clear the inner part of a window was added.
  145.  
  146.     A new function to size (and move, if necessary) a window was
  147.     added.
  148.  
  149.     Bug fix in assembly language include file.
  150.  
  151. * 37.2  (02-May-96)
  152.     Started programming in StormC and did some tests with the library,
  153.     noticed that there was a couple of errors in some include files.
  154.  
  155.     GU_UpdateProgress was wrongly specified in the FD/clib files.
  156.     The output of GU_GetGadgetPtr was specified as (struct Gadget *),
  157.     this is now corrected.
  158.  
  159.     Included an example in C that uses the PROGRESS_KIND gadget.
  160.  
  161. * 37.1  (01-May-96)
  162.     IMAGE_KIND gadget bug fix. The color of the unselected image of
  163.     the gadget was wrong, if the image used more than 4 colors.
  164.  
  165. * 37.0  (29-Apr-96)
  166.     A new function that checks the library's revision added.
  167.     Two new tags added: GU_FractWidth and GU_FractHeight. Suggested
  168.     by Morten Amundsen.
  169.  
  170.     Some small bug fixes in 'C' include files (unterminated comments).
  171.     Cleaned up BetterTest.c a bit (removed some {}). Bug fix on the
  172.     last line of the example (GT_ReplyIMsg -> GU_ReplyIMsg).
  173.  
  174.     Added support for StormC in both installer script and include-
  175.     file installer. Created dictionary for StormC, so that all words
  176.     that belongs to GadUtil (functions, tags and constants) is shown
  177.     in another color.
  178.  
  179. * 36.60 (24-Feb-96)
  180.     Uses the screen's font as the gadget font if no GU_DefTextAttr or
  181.     GU_TextAttr tag is used. Bug fix from v36.59. Changed some docs,
  182.     assembled all examples,    changed installation scripts.
  183.  
  184. * 36.59 (06-Jan-96)
  185.     More docs completed (all docs, finally). Bug fix in the GU_AutoWidth,
  186.     GU_AdjustLeft and GU_AdjustRight tags. The underscore character was
  187.     counted as a normal one. This made gadgets without hotkeys one char
  188.     smaller than other gadgets. A new function that sorts one or two
  189.     lists was added. Some new constants added in include files.
  190.     Changed GU_MinimumIDCMP to support hotkeys. Changed PROGRESS_KIND
  191.     to use GU_GadgetText and GU_LocaleText. Uses the screen's font as
  192.     the gadget font if no GU_DefTextAttr or GU_TextAttr tag is used.
  193.  
  194. * 36.58 (01-Jan-96)
  195.     SLIDER_KIND and SCROLLER_KIND gadgets returned wrong result in
  196.     im->Code if the gadget was changes using the hotkey. Bug reported
  197.     by Lukasz Szelag.
  198.  
  199. * 36.57 (10-Dec-95)
  200.     Some more docs finished. A memory loss bug was fixed.
  201.  
  202. * 36.56 (10-Oct-95)
  203.     Changed some routines, so that hotkeys can't be used on disabled
  204.     gadgets. Made it possible to disable IMAGE_KIND, FILE_KIND and
  205.     DRAWER_KIND gadgets.
  206.  
  207. * 36.55 (30-Sep-95)
  208.     Bug fix in the hotkey part of the library. Wrong code were sent back
  209.     when using GU_LabelHotkey with a LISTVIEW_KIND gadget. A new gadget
  210.     kind was created, PROGRESS_KIND.
  211.  
  212. * 36.54 (06-Jul-95)
  213.     Added support for GU_AutoWidth to CYCLE_KIND gadgets.
  214.  
  215. * 36.53 (05-Jul-95) 
  216.     3 new tags and 4 new flags was added for the BEVELBOX_KIND gadget.
  217.     BEVELBOX_KIND gadgets can now have a shadow added to the text in the
  218.     border. The "sun" can be placed in 4 different places. GU_MinimumIDCMP
  219.     tag was added.
  220.  
  221. * 36.52 (25-Jun-95)
  222.     First public release. Some new flags for the BEVELBOX_KIND gadget was
  223.     added. Supports a total of 100 bevelbox kinds.
  224.  
  225.  
  226.  
  227.                                           P-O 961222
  228.                                           ~~~~~~~~~~
  229.  
  230.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  231.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  232.         Per-Olof Yliniemi                           Staffan Hämälä
  233.         Box 78                                      Pellovägen 268
  234.         SE-980 61 Tärendö                           SE-957 93 Pello
  235.         SWEDEN                                      SWEDEN
  236.  
  237.         email:                                      email:
  238.           peoyli@algonet.se                           staham@algonet.se
  239.  
  240.         phone:
  241.           +46-(0)978-20522
  242.  
  243.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  244.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  245.